home *** CD-ROM | disk | FTP | other *** search
/ Aminet 31 / Aminet 31 (1999)(Schatztruhe)[!][Jun 1999].iso / Aminet / comm / news / slrn-bin.lha / slrn / doc / INSTALL < prev    next >
Text File  |  1998-05-03  |  4KB  |  89 lines
  1. !!Note: See README first instructions on building slrn!!
  2. This file concerns the ``advanced'' installation of slrn.  By ``advanced'',
  3. I mean multiple-user installation.   The installation instructions given in
  4. this file provide information about setting up slrn with defaults that are
  5. global to all users.  These defaults include such information as the name of
  6. the organization and the hostname.  In addition, only one newsgroup
  7. description file is needed instead of one per user.
  8.  
  9. Basically the idea is to create a directory know as the SLRN_LIB_DIR.  The
  10. default value of this directory is /usr/local/lib/slrn (VMS: sys$manager:).
  11. Simply put the files that you want all users to share in that directory.
  12. Currently only two files are meaningful:
  13.  
  14.     slrn.rc           :  defaults for all users
  15.     newsgroups.dsc    :  newsgroup description file.
  16.  
  17. On my system, SLRN_LIB_DIR/slrn.rc file simply contains the two lines:
  18.  
  19.    hostname space.mit.edu
  20.    organization "Center for Space Research"
  21.    
  22. which will appear in the appropriate headers when a user posts a message.
  23. In addition to specifying these quantities in the slrn.rc file, suitable
  24. defaults may be compiled into the executable.  Simply edit the slrnfeat.h file
  25. for this option.
  26.  
  27. The rest of this document describes how the SLRN_LIB_DIR may be specified as
  28. well as how the newsgroups.dsc file may be created.
  29.  
  30. Background:
  31.  
  32.   When slrn runs it looks for a file that contains the description of all
  33.   the news groups.  This is NOT the newsrc file.  Rather, it is a file that
  34.   contains a one line summary of what each group is about.  This file can be
  35.   quite large if there are many newsgroups.  For example, on my system, the
  36.   newsgroup description file is 225 Kilobytes.  It is not desirable for each
  37.   user to have their own private copy of this file, especially when more
  38.   than one user uses slrn on a given system.  Instead, the system manager
  39.   only has to keep a copy of it in a directory that slrn knows about.  Part
  40.   of the installation process described in this file involves the creation
  41.   of such a directory.
  42.  
  43.   slrn assumes that newsgroup description file will be called
  44.   `newsgroups.dsc'.  The directory where this file is located must be
  45.   specified by you.  This can be done in one of three ways:
  46.   
  47.       1. By compiling slrn with the directory name hard coded in.
  48.       2. Through the use of the SLRN_LIB_DIR environment variable.
  49.       3. Simply using the default of /usr/local/lib/slrn.
  50.  
  51.   The third option is the easiest because all you have to do is make sure
  52.   that the directory exists.  If you do not have the proper privileges to
  53.   create such a directory, then you will have to choose one of the other two
  54.   options.
  55.  
  56.   Now, you have to obtain the newsgroup description file. You can do that in
  57.   at least two ways.  The easiest is to simply get the file `newsgroups.dsc'
  58.   from space.mit.edu:/pub/davis/slrn.  The other method is just as easy but
  59.   involves slrn to create such a file for you.  This is described below.
  60.  
  61. With this background, the steps presented below should be clear.
  62.  
  63.   0. Execute the steps outlines in README before continuing.
  64.   
  65.   1. Create the directory `/usr/local/lib/slrn'.  Alternatively, create
  66.      another directory such as $HOME/lib/slrn and put 
  67.       
  68.          setenv SLRN_LIB_DIR $HOME/lib/slrn
  69.      
  70.      in your .cshrc file.  If you use a different shell, the syntax will be
  71.      different.
  72.   
  73.   2. Run slrn as follows:
  74.   
  75.          slrn -f SLRN_LIB_DIR/newsgroups -d
  76.      
  77.      (Of course, make the proper substution of SLRN_LIB_DIR).  This will
  78.      create a file newsgroups.dsc in the SLRN_LIB_DIR.
  79.      
  80.      This step may take some time to complete for slow NNTP connections.
  81.      
  82.   3. If more that one person will be reading this file, make sure it is
  83.      world readable, e.g.,
  84.      
  85.          chmod go+r SLRN_LIB_DIR/newsgroups.dsc
  86.  
  87.  
  88. That's it!!
  89.